Skip to content

Some improvements to the way we allocate and track snapshot ids - #784

Open
Julian Gutierrez Oschmann (juli4n) wants to merge 1 commit into
agent-substrate:mainfrom
juli4n:snapshot_ids
Open

Some improvements to the way we allocate and track snapshot ids#784
Julian Gutierrez Oschmann (juli4n) wants to merge 1 commit into
agent-substrate:mainfrom
juli4n:snapshot_ids

Conversation

@juli4n

@juli4n Julian Gutierrez Oschmann (juli4n) commented Aug 6, 2026

Copy link
Copy Markdown
Collaborator

Fixes #773

Some improvements to the way we create, track and propagate snapshot ids.

  • Consolidate snapshot id and name into a single concept.
  • Use consistent terminology across the whole stack (i.e. remove confusion about prefix vs id vs name).
  • Get rid of internal only storage to hide the snapshot URI.

@juli4n Julian Gutierrez Oschmann (juli4n) changed the title WIP Some improvements to the way we allocate and track snapshot ids Aug 6, 2026
@juli4n
Julian Gutierrez Oschmann (juli4n) force-pushed the snapshot_ids branch 3 times, most recently from eb89114 to 3030f69 Compare August 6, 2026 20:19
…ids.

* Consolidate snapshot id and name into a single concept.
* Use consistent terminology across the whole stack (i.e. remove confusion about prefix vs id vs name).
* Get rid of internal only storage to hide the snapshot URI.
Comment on lines +33 to +44
// SnapshotURI is where one ActorSnapshot's objects live in object storage:
// an ActorTemplate's snapshotsConfig.location, plus /snapshots/<atespace>/<name>.
//
// gs://bucket/root location
// gs://bucket/root/snapshots/team-a/<name> this URI
// gs://bucket/root/snapshots/team-a/<name>/... an object in the snapshot
type SnapshotURI struct {
uri string
location string
atespace string
name string
}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see that this is moving the snapshot back into an atespaced key. I specifically undid this in my PR to ensure that later tags could be made global, or potentially move between atespaces without confusion. However, given that we made tags atespaced I think it should be safe to go back to this. The only thing I'll mention is the situation where we want to copy tags to specific atespaces, if the snapshots are atespaced we'd probably need to copy the data

Comment on lines +583 to +584
// The store round-trips the whole resource, snapshot_uri included: it is
// an ordinary field now, not a value the store keeps beside the record.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just FWIW on this, the reason was to hide the storage internals from the snapshot resource itself, and users who have access to it. But in hindsight that might've been unnecessary

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Some improvements to actor snapshots

2 participants